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INTRODUCTION 

GENERAL 

The CO3J0L 74 MCS Chereafter just MCS) was implenented to demon- 

Strate alk data communication facilities via COBOL 74e Tt 

provides many features» tne most important of which is that the 

source code will ce releasad 3s well as the objecte This wilt 


zllow the user to see exemples of the various MCS functions used 
to sunport COSBDBL 74. 


The MCS was imolemented to be run under the control of SMCS. To 
use it without the aid of S¥CS would only inconvenience the user. 
It is important that there be only one copy of the NCS running at 
any one time. 


: Bak § 


1-2 


~ BURROUGHS CORPORATION COMPANY CONFIDENTIAL 


COMPUTER SYSTEMS GROUP 31300/817090 COSCL74 MCS 
SANTA SARBARA PLANT PeSe 2233 2885 CA) 


OPERATING INSTRUCTIONS 


The MC3 was designed to run along side SMCS and therebdy takas 
advantage of its presercee To use the MCS fer the first time» 
you first have to make an antry in SHCS*s "JABS" file. (This 
should include "COPIES=1' when running with the 11.20 release of 
SMCS» and "LOUGtON' ait the time.) For example? 


$8 MCS74 LGoarIn COPIES=1 5 EXECUTE MCS74 PR 12 + 


Then on2 would tojyon to SMCS» and enter *GN <*CS designator>*. 
The MCS will then o@ executed and open a remote file that wili be 
attached to your station. 


Supocse we had to run an inventory orogram catled *INVENT™» which 
requires INITIAL INPUT. The MCS requires that atl such programs 
have an entry ina file calhed “YNAME/"INITINPUT®™. (See the 
section on INITIAL INPUT FILE FORMATS.) The user would mak2 an 
entry in tha MYNAME/S™INITINPUT™ file with the chosen designator 
of "I" to execute the program "INVENT™. For examole: 
# FT > EXECUTE INVENT > 

At the remote2 stetions one would specify "4 I *» which indicates 
that th2 foliowtng message is for the program associated with 
"rT". tTnen the user would decide which queue that the program 
expects to read the messegea out of» and that is specified ody 
combinations of “"P"3 and "5%5. These tatters indicate tne 
choices petween orimary and seccndary queuease Four tevels are 
po0ssibles Dut those that are left off the rignt end are filled 
with "P"%s. That also implies that if the acueue specifier is Left 
out entirely» “FOPP" 165 assumede Following this is th2 message. 
The massage car £2 un to the balance of the screen. Ensuing 
messages that ar2 to 53 Jelivered to the same queue and the same 
program naed mot have those soecified. fhe primary and secondary 
Gueue names are defines callad "PRIMARYQNAMC™ and "SECOCNDARY3- 
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They are currently defined ¢s "HIGH" and "LOW" respectively. 
That imolies that "PPSP"» for e2xamoles designates tne queue name 
WHIGH"/J™TETGH"/ "LOANS "HIGH" and "P5"% destanates the queue nam23 
"HIGHT/S*LOW"/STRICH"/S"HIGH". Here 15s the form: 


yr os <oraganr designator> BpeEEe@eueenmeaewaw@weaesee ee eee a2 2 SB @ @ BD @ @ ow <message> 
I- <queue desianator> 1 
tach 15 separated Dy one or mora dslankse For example: 
4 [ PPSS This is the initial input message. 

This specificétion will caus2 the messag2a2 “"PPSS This is tha 
initial inodut messagee” to be enqueued in tha queue named “HISH*S 
"HIGHT/*LOW"/"LUW. 
Tne H€5 has six fites dectared. Externatly their names are2 


MYNAMES™RAT » MYNAREST TRACE ™ > MYNAMES™SCHO™» MYNAME/"™IJO3IQ™» 
MYNAME/™OVELO"» MYNAME/S@PINITINGUT™ > and MYNAME/S"SEGFILE*%. MYNAME 


15 3 String of characters which CAN be the MCS* name. CIts 
default is “ACS74". MYNAMC/TTRACEFILE”* is a printer backup file 
that is crested unon denand ty one of two different ways» the 


specification of the "FRACE™* command or the setting of program 
Switch OO eguéel to 1 ortor to the execution of the MCS. 
MYNAME/™SCHS" and MYWAMC/"™JO03BR" are queues that are used by the 
MCP to return jos soawning informnatione MYNAME/S*PINITIANPUT™ as 
the name of the file used to specify which jobd should be sdawned 
due to an tnitial input (see form3t). MYNAME/™SEGFILE* 35 #4the 
name of a diskfile that is used to teamoorarily store S=EGMENTs of 
messages ud until the entire message has d2aen receivedy by the 
MCS. MYNAMES "QVFLO" 2s to nandle an ovarflow of messaces from 
MYNAME/S“REMOTE®. 


Specificaticn of a string to be soawned by the MCS 15 £accomp- 
lished when tha token following the pound sign ("#8") 315 a ques” 
tion mark ("2"). The balance of the message witli then be 
Scawnede For examples: 


$7 EXECUTE HS/CHSI/CMIINIC = 
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COMMANDS 


There are several commands avaitadbles such as “PASSWORD"» “BYE™>» 
TASSIGN™s "STOP™> "TRACE™s “"EST%» "STATUS" and “"HELP™. ALL of 
the commands are delimited by olanks. They can be used from 3 
station if preceded oy a pound sign C4"). Following is a 
description of each: 


PASSWORD 


Soecification of *PASSW2R907 only will return the current setting. 
lf the command is fotlowad by “*"» or ten Dlanks» the opassword 
witli be cleared. If the command is followed pdy a token 
consisting of up to ten characters (not including embedded odtlan- 
KS)» tne dassword 15 Sete 


PASSWORD sec ecccccces eee ee eee en-e- eee Litcieone ec eeousuewe see seed 


l--- <password> 7-71 
{ | 


Jo--9+-- o oenenern-! 
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STOP 


The ST3P command is used to begin an immediate shutdown of the 
MOS and all of the joss still executing under it Cthat do not 
have NODIF specified). 
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TRACE 


Soecification of this command alone responds with its mode. 
Following the command with 93N or OFF respectively sets the mode 
as desired. Anotner means for starting the trace facility (Cat 
cod of the ¥CS only) 15 setting program switch O equal to le 


The printer backun file that 15 created has the following format: 


{time}.echaracter ( 12) 

TIL LO 46% 636s Seek 2) 
Csourceordestinat ian wewsecovseseel 19) 
51 1 °OT & 6G ww we ew oe ok 1) 
Ptraceline 1] sé0< esee See Cl INEST ZED) 

G64 2S 16 wise eoo eae ect 2) 

TULL Of 5.0S-46es oe ew ek 5) 


132 characters 


The {Csourceordestination] field contains the name of the source 
or destination followed bd5y an arrow to the right or the left. 
The possidle categories ares"JDT™» "*SCHI% >» "RMT" >» "JOSE%> MINIT *s 
T7IP™>s “"SEE%> “"JVFQ" and a spacial case "DEBUG". "DEBUG" 15 the 
only category that 15 followed dy asterisks instead of an arrow. 
For example Cwrapoped around): 


YS2OG4sL2.LAM RYT anem> 0199127901100 70000000000 770000TC9009 


QUGSelCC4s 2PTPPZIE JUNK PPSP al 
93294323. 3AM INIT iner> # JO3L 5 EX J931> 
00000190 30 


93294:28.9AM OF3UG *eee JOBSINFILE = 1 


Tne Ftracetine] field consists of one or more lines of LINcCSI 7c 
(default=1909) byte segmants of the actual data traced. (This 
also inctudes the 30 cyte dataccum header.) 


The £5122] field shows the byte tangth of the Etracetinel field. 


TRACE a sp Sennen annmanawnwanesaae a ne emaanawwe ws = a swan uwuaa a seu nswoewnmroewenvansan ean asa ae a 
j i 
[---- ON ----- | 
{ : 
Jon-= OFF ----1 
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BYE 


The 3YE command causes that station to p@ detached from the MCS. 
it cannot be used from the 2937. Specification of this command 
also UNASSIGNs tne station and if no other stations are currently 
on the MCS» it will go to 2:0}. 


BYr ageweeaeoooqeq@qddsaepweeuweeaene 2 & & seu ene en een enw waece tase wesw meme ste nsw esteem este eeece | 
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ASSIGN 

The ASSIGN command i383 used ta cause alt the tnnout fron a partic 
ular station to pe engueued into the specified queue. The form 
is "ASSIGN <qnam2>*. If <qnam2a> equals a hyphen (""-")» then the 
station wilt be unassigned. Specification of the STATUS command 
will disptay assignments. The <qgname> can be of any forme and 
any length up to 48 characters including emoedded blanks. This 


<aname> is used as given» and does not have to be one of the 
eight primary or secondsary queues. 
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ESI 


Specification of FST alone will return the value of the End-of- 
Segmentwindicator charactare Tne default value is ETX (303d). 
The display will de as a character» (some characters are filtered 


out by SYSTE“/ODT before they are disolayed). If a chéracter 
follows the command the ESI value will be changed to that char- 
act2fre If a hexadecimat string ("a<two graphics O79 and AwF>d™) 


is specified because the desired ESI vatue does not have a 
graphics then the ESI value is set to that value. For examole: 


ESI 340d 
will set the £81 cnaracter to tna value of olank. The Emi and 
FSI values are also set to 3 default of 3032. These can only b2 


changed oy changing the source racords that certain to their 
definition» and recompiling. 


Jm-r~- 3 <two gréenhics 979 and AerF> Q ===") 
I ! 
tests < One Character fol, 2 reste a ee i 
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STATUS 


Specifiation of STATUS alone will return the status CENABLED or 
DISASLED) and their ASSIGNments of all "known™ Lsns»e while also 
ce oteane an tsn numbere will only return the status of that 
isn 


ST ATUS eenenasreanceananwcanacannecmacannaeaesanaeamecaenaonenon en asecnan econ ece= | 


i | 
jerm~ <isn numder > ~-"71 
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HELP 


Specification of HELP alone will return a List of iegal commands» 
white specifying a varticular command wiil return the allowadle 
syntax and response for that command. 


po=~ HELP ---2-""1 
f--- PASSKORD <9! 


l--- STOP -ec"-- 
Jers TRACE coeee- 
pore ES] eacnsee- 
poo AYE oce-- <=! 


P--- ASSIGN s-2"01 


fe-= STATUS ----- l 
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INITIAL INPUT FILE FORMAT 


The format of the “INITINOUT" is very similar to that of S5MC5"%s 
"j39395" file. Tha format is as follows: 


A pound sign ("#") must be in column one of every new entrye The 
next token must be the desirable string of characters that one 
wisnes to use to specify initial input to the program that will 
be executed in that entry. Following that designator» a semi- 
colon ("3") is required. Following that can de all the necessary 
oDT conmands» fiile2 equates» switch settings» etcetera to execute 
the desired job. This should end with another semicoton ("sr"). 
As many Lines as is necessary can be used» but only the first 
need begin with a pound sign ("47). The string» as it appears in 
the file will be spawned» so it is important to be sure that the 
syntax 43S ccrrects 
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